package com.example.question.service;

import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import com.example.question.entity.QuestionCategory;

import java.util.List;

/**
 * 题目分类服务接口
 * 继承MyBatis-Plus的IService，提供基础的CRUD操作
 * 定义题目分类相关的业务操作方法
 * @author 颜殿
 */
public interface QuestionCategoryService extends IService<QuestionCategory> {
    /**
     * 添加题目分类
     * 创建一个新的题目分类
     * @param category 题目分类实体，包含分类的基本信息
     * @return 添加是否成功
     */
    boolean addCategory(QuestionCategory category);

    /**
     * 删除题目分类
     * 根据ID删除指定的题目分类
     * @param id 要删除的题目分类ID
     * @return 删除是否成功
     */
    boolean deleteCategory(Integer id);

    /**
     * 修改题目分类
     * 更新指定题目分类的信息
     * @param category 包含更新信息的题目分类实体
     * @return 更新是否成功
     */
    boolean updateCategory(QuestionCategory category);

    /**
     * 分页查询题目分类
     * 获取题目分类的分页列表
     * @param pageNum 页码，从1开始
     * @param pageSize 每页记录数
     * @return 分页结果，包含题目分类列表和分页信息
     */
    Page<QuestionCategory> pageCategories(Integer pageNum, Integer pageSize);

    /**
     * 查询题目分类的题目数量
     * 根据分类名称和题目标题进行比对查询
     * @param name 分类名称，支持JSON格式
     * @return 题目数量
     */
    Long countQuestionsByCategory(String name);

    /**
     * 获取所有题目分类
     * @return 题目分类列表
     */
    List<QuestionCategory> listAllCategories();
} 